home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / Drivers / opal_real.lzh / OVRealMan.DOC < prev    next >
Encoding:
Text File  |  1992-10-31  |  13.0 KB  |  406 lines
  1.  
  2.                 Real 3D to Opalvision display driver.
  3.  
  4.  
  5.  
  6.                      OVRealPanel User's Manual 
  7.                              produced 
  8.                                 by
  9.                       Digital Machine Concepts
  10.                              Australia
  11.                                1992 
  12.  
  13.  
  14. PLEASE NOTE THAT FOLLOWING IS A DIRECT EXTRACT OF THE PRINTED MANUAL
  15. SUPPLIED WITH THE FULL VERSION.  MANY OF THE FEATURES DISCRIBED IN THIS
  16. MANUAL ARE ONLY AVAILABLE IN THE PURCHASED APPLICATION.  ALSO THE FOLLOWING 
  17. TEXT HAS REFERENCE TO FIGURESS THAT COULD NOT BE INCLUDED IN THE DOCUMENT.
  18.  
  19. THE INSTALLATION INSTRUCTIONS DISCRIBED BELOW MENTION A INSTALLER 
  20. PROGRAM WHICH HAS NOT BEEN INCLUDED IN THIS ARCHIVE.  PLEASE FOLLOW THE
  21. "NON STANDARD INSTALLATION" INSTRUCTIONS.
  22.  
  23.  
  24.  
  25.  
  26. This manual is copyright  (c)  1992 Digital Machine Concepts.
  27. All rights are reserved.
  28. The software supplied with this manual is copyright  
  29. (c)  1992 Digital Machine Concepts. All rights reserved.
  30.  
  31. This document may not be reproduced, 
  32. photocopied, digitised, translated or copied in whole 
  33. or part without the consent of Digital Machine Concepts Australia.
  34.  
  35. opalvision is a registered trademark of opal technology Inc.
  36. Real 3D is a registered trademark of Realsoft.
  37. Amiga is a registered trademark of Commodore-Amiga, Inc.
  38. Commodore and CBM are registered trademarks of Commodore Electronics Limited.
  39.  
  40.  
  41. ACKNOWLEDGEMENTS.
  42.  
  43. We wish to acknowledge opal technology for their support and congratulate 
  44. them on an outstanding product.
  45. We also take this opportunity to acknowledge Creations Audio Visual 
  46. Services, Australia.
  47.  
  48.  
  49. DISCLAIMER
  50.  
  51. Digital Machine Concepts makes no warranties, either expressed 
  52. or implied, with respect to the software described herein.
  53. This software is sold 'as is.'  All care in its preparation has
  54.  been taken but all responsibility is assumed by the purchaser.
  55. Under no circumstances are Digital Machine Concepts liable for
  56.  direct, indirect, incidental or consequential damages resulting 
  57. from the use or defect of the software described herein.
  58.  
  59.  
  60. Produced by Digital Machine Concepts in Australia, 1992 revision 1.1.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.            OVRealPanel Driver.   Real 3D version 1.4   
  68.  
  69.                       Ver 2.x
  70.  
  71.                  TABLE OF CONTENTS
  72.  
  73.  
  74.                Product Description        1
  75.                Installation               1
  76.                Non-Standard Installation  2
  77.                Rendering to opalvision    3
  78.                Opalvision control panel   4
  79.                Using the Framebuffer menu 5
  80.                Saving options             6
  81.                Rendering status reports   7
  82.                Product support            7
  83.                
  84.                
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92. Please remember to send us your registration.
  93.  
  94. The installation of Digital Machine Concept's opalvision display drivers 
  95. enables 24 bit display integration with your system's productivity software.
  96. Our opalvision drivers are designed to provide maximum utilisation of 
  97. opalvision's resources to fully complement your Desktop video publisher 
  98. or Rendering packages.
  99. At Digital Machine Concepts we are committed to continually updating 
  100. our products and are pleased to inform registered patrons of product 
  101. updates when they become available.
  102. We look forward to your registration or any inquiries regarding our 
  103. range of products.
  104.  
  105. Installation.
  106.  
  107. Boot your machine to your normal Real 3D working environment. Important, 
  108. do not launch Real 3D at this point.
  109. Insert the distribution disk into the internal floppy drive DF0: , 
  110. provided on this disk is an install utility. You must now initiate 
  111. the install procedure. It is recommended that you launch  Installer 
  112. from the workbench by first 'double-clicking' the Disk icon, then the 
  113. Installer icon. When installing from CLI simply type 'DMC:Installer' and
  114.  press return.
  115. If problems are reported by the installer consult the section entitled 
  116. Non-Standard Installation.
  117.  
  118.  
  119.  
  120. for Release 20 Sept 1992 page 1.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133. Non-Standard Installation.
  134.  
  135. Note: This section is intended for the intermediate to advanced 
  136. users who wish to manually install the display driving software.
  137.  
  138. A framebuffer library must be included in your system libs: 
  139. drawer for Real 3D to make use of opalvision. Both library 
  140. files 'opal_r3d.library' and 'opal.library' must be present
  141.  in the libraries drawer referenced by Real 3D.
  142. If 'opal.library' is not already present in your libs: drawer
  143.  copy this from your opalvision distribution disks.
  144.  
  145. Now copy 'DMC:libs/opal_r3d.library' to your required libs: drawer.
  146.  
  147. While Real 3D is running the driver daemon must be active.
  148.  It is suggested that this be launched on system startup. As
  149.  such, we recommend its inclusion in the system drawer WBStartup. 
  150. If launching from a CLI script file, for instance, the
  151.  'user-startup' the daemon must be 'run'.
  152. Copy the daemon file, 'DMC:other/OVRealPanel' into a drawer
  153.  within the system path. The command line in the custom script
  154.  file should resemble the following.
  155.  
  156.          ' sys:c/run >nil: REAL:OVRealPanel '
  157.  
  158. This is all that is required to install the Real 3D opalvision
  159.  display driver.
  160. Remember that you must have 'OVRealPanel' running as a background
  161.  task as outlined above. Any attempt to open a 24 bit frame will
  162.  result in an error which informs you that Opal Panel is not present.
  163.  
  164. If your manual installation fails please feel free to contact
  165.  us for additional installation assistance.
  166.  
  167.  
  168. page 2.
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180. Rendering to Opalvision.
  181.  
  182. Once Installation has completed re-boot your Amiga.
  183.  If you have followed the recommended installation process
  184.  a window will open temporarily on startup to inform you that
  185.  the OVRealPanel is installing. The following steps outline a
  186.  simple test of the installation and introduces rendering to
  187.  opalvision from Real 3D.
  188.  
  189. 1.    Open Real 3D then load a desired scene into the editor.
  190. 2.    Select Modes > Solid in the pull down menu. 
  191. 3.    Select Framebuffer > library in the pull down menu.
  192. 4.    Type 'opal_r3d.library' then press return.
  193. 5.    Under the framebuffer pull down menu extra items will
  194.     now appear.
  195.     Possible Errors    
  196.     If not, check you have entered the library name correctly,
  197.      otherwise your installation has failed. See the section 
  198.     entitled ' Non-Standard installation.'
  199. 6.    Make sure that IFF-24 is selected in the Options panel.
  200. 7.    Select Framebuffer > Openscreen. The screen will blink.
  201.     Possible Errors
  202.     Any Alert occurring at this point regarding a 'panel task'
  203.      indicates that the daemon is not active. Ensure that
  204.      'OVRealPanel' is running.
  205. 8.    Select the Render button.
  206.  
  207. At this point the opalvision display panel will pull
  208.  into view and the image will render from the top of
  209.  the display. You may at any time select options on the
  210.  opal control panel. Some options will cause rendering to
  211.  halt. For example, selecting the save function before
  212.  rendering has completed. On completion of these functions
  213.  rendering will resume.
  214.  
  215. Accompanying the opal control panel are further functions
  216.  listed under the frame buffer pull down menu. Including a
  217.  'set display modes' option which allows you to configure Hi
  218.  or Low resolutions, Overscan displays and Interlacing.
  219.  
  220.  
  221. Real 3D version 1.4
  222. page 4.
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232. Opalvision Control Panel.
  233.  
  234. The control panel displays render statistics and presents a
  235.  number of button gadgets which allow you to, save the current
  236.  image, hide the panel display and return to the Real 3D solid
  237.  modeller. The panel display acts as the control medium between
  238.  the Real renderer and your custom opalvision view.
  239. Below is the main panel display. The particular button and
  240.  associated function are outlined below.
  241.  
  242. !SAVE IMAGE! RETURN TO REAL! TIME 00:00:00 !HIDE! !ABOUT!
  243.  
  244. Opalvision main control panel
  245.  
  246. 1.2.3.4.5.6.
  247.  
  248. Description.
  249. 1.    Click once with left mouse button to bring Real 3D     into     view.
  250.  This operation does not stop any rendering 
  251.     in progress, a progress indicator is maintained on both     views.
  252. 2.    Click once with left mouse button to activate the     'Image     Save'
  253.  panel. This operation may be executed     at any time,     this allows
  254.  partial image saving.
  255. 3.    Click to cycle a status output while rendering. Cycle     to     
  256. either elapsed time, current scan line or image size.
  257. 4.    Cycle gadget output region.
  258. 5.    Click once with left mouse button to remove the panel
  259.     from the 24 bit display. Clicking the mouse again
  260.     restores the panel image.requires
  261.  
  262. page 5.
  263. OpalVision Control Panel.
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271. When an opal frame is open the only acceptable method of returning
  272.  to the Real 3D view is by selecting the return to Real button.
  273.  Visible on the Real Screen is a new button which can be selected
  274.  to return the opal display and control panel into view.
  275.  
  276. Using the Frame Buffer menu.
  277.  
  278. The  frame buffer  menu, which is present on the solid modeller
  279.  menu bar,  controls the opal display. Before rendering to an opal
  280.  display a frame must be opened.  The opal panel remembers your
  281.  display options. Once a screen mode is set all opal screens will
  282.  open with the predefined display parameters. When selecting
  283.  'Openscreen' a 24bit display is created.
  284.  
  285. Note that different screen modes have different memory requirements.
  286.  The recommended system configuration is 2 Meg of Chip memory
  287.  plus another 1Meg of Fast memory. The driver will operate with
  288.  One Meg of Chip but this limits the choice of screen modes. If
  289.  the requested mode is unobtainable the mode defaults to a low
  290.  resolution screen.
  291.  
  292. The display options cannot be set while a dispay frame is closed.
  293.  Selecting the set modes option while a frame is closed will have
  294.  no effect. Select the 'Openscreen' option, then select the set
  295.  modes option. A panel containing a set of cycle gadgets will
  296.  appear. Simply cycle the gadgets until the desired display
  297.  parameters are displayed on the panel. 'Set' these modes and
  298.  the new frame will open using your display options.
  299. Opening multiple screens is not currently supported by Real 3D
  300.  or the display driver. Attempting to 'Openscreen' more than
  301.  once will have no effect.
  302.  
  303.  
  304. Real 3D version 1.4page 6.
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312. Saving Options.
  313.  
  314. Image saving to disk from Real 3D can be achieved using three
  315.  different save options. The first two options are contained
  316.  in the frame buffer pull down menu.
  317.  
  318. 'Save Image' will open a Real 3D file requester. Select a path
  319.  and enter a file name to save as an IFF24 image.
  320. 'Save Custom' will again open a Real 3D file requester.* This
  321.  provides an alternate route to the save option on the opal panel.
  322.  
  323. The recommended method of saving images is through the Save option
  324.  on the Opal control panel.  Once the save option is selected a new
  325.  panel is displayed with a cycle gadget to select between IFF24 and
  326.  JPEG saving configurations. A thumbnail, the opalpaint icon, will
  327.  be generated if this option is ticked. Clicking the thumbnail region
  328.  toggles the selection.
  329. If JPEG is selected the quality factor can be selected with the slider
  330.  gadget. Selecting 100% represents lossless compression. The higher
  331.  the quality percentage the larger the image file, conversely, with
  332.  lower quality the image file size is reduced.
  333. If IFF24 is selected the slider is disabled since no other save
  334.  options are required.
  335.  
  336. Selecting the save option from the save panel will open a file
  337.  requester on the opal backdrop. Choose a path and file name,
  338.  select OK to begin the saving procedure.
  339. Saving from the opal control panel is selectable at anytime
  340.  while the panel is in view. As such the frame rendering does
  341.  not have to be  completed and allows partial image rendering
  342.  and saving.
  343.  
  344. Whilst rendering the save options present in the Real 3D
  345.  pulldown menu are NOT available.
  346.  
  347. Again, we recommend all saving to be done from the opal
  348.  display panel using the save image option.
  349.  
  350. Real 3D version 1.4 page 7.
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362. Rendering Status reports.
  363.  
  364. Rendering status is reported on both the opal control panel and upon
  365.  the Real 3D view.
  366. On the main opal control panel the cycle gadget selects either,
  367.  Elapsed rendering time, Image size, and current scan line number
  368.  being rendered.
  369.  
  370. The elapsed time count is reset upon the initiation of a render
  371.  and halted upon its completion. The current scan line reports
  372.  the vertical line number currently rendering. On completion of
  373.  the render it reports ALL completed. The image size option
  374.  displays the resolution of the current display, not the current
  375.  image. Any image size can be rendered by editing the width
  376.  and height parameters on the solid modeling panel.
  377. When the Real 3D view is forward the current scan line
  378.  is reported near the render button.
  379.  
  380.  
  381.  
  382. Product Support.
  383.  
  384. If you discover bugs in any of our software products we would
  385.  like to know about it. We are also keen on hearing your suggestions
  386.  for improving our range of drivers so that you can become more
  387.  productive with your opalvision unit.
  388. You can send your bug reports or upgrade suggestions
  389.  to the following address.
  390.  
  391.             Digital Machine Concepts.
  392.             Drivers: Opal Real 3D driver.
  393.             P.O. Box 37
  394.             Darlington
  395.             Western Australia, 6070.
  396.             ph     (61) 9 299 6153
  397.             fax (61) 9 299 7593
  398.             Email : tnewmanda@cc.curtin.edu.au
  399.  
  400. FOR THOSE HOW HAVE READ THIS FAR (AND HOPEFULLY WANT PURCHASE A FULL
  401. VERSION), OVREALPANEL IS AVAILABLE FROM THE ABOVE ADDRESS FOR $US49 
  402. OR $Aust59 INCLUDING POSTAGE AND PACKAGING.
  403.  
  404. Real 3D version 1.4 page 8.
  405.  
  406.